home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / prgtools / gnustuff / tos / futils / futils~1 / src / misc1s.zoo / misc1 / find-3.2 / README < prev   
Encoding:
Text File  |  1991-08-21  |  3.1 KB  |  69 lines
  1. This package contains the GNU find, xargs, and locate programs.  find
  2. and xargs comply with POSIX 1003.2 draft 11.1, as far as I know.  They
  3. also support some additional options, some borrowed from Unix and some
  4. unique to GNU.
  5.  
  6. To compile these programs:
  7.  
  8. 1.  At the top level (the directory this README is in), type
  9. `./configure'.  This shell script attempts to guess correct values for
  10. various system-dependent variables used during compilation, and
  11. creates the Makefiles.  This takes minute or two.
  12.  
  13. If you want to compile in a different directory from the one
  14. containing the source code, `cd' to that directory and run `configure'
  15. with the option `+srcdir=DIR', where DIR is the directory that
  16. contains the source code.  The object files and executables will be
  17. put in the current directory.  This option only works with versions of
  18. `make' that support the VPATH variable.  `configure' ignores any other
  19. arguments you give it.
  20.  
  21. If your system requires unusual options for compilation or linking
  22. that `configure' doesn't know about, you can give `configure' initial
  23. values for variables by setting them in the environment; in
  24. Bourne-compatible shells, you can do that on the command line like
  25. this:
  26. $ CC='gcc -traditional' LIBS=-lposix ./configure
  27.  
  28. 2.  If you want to change the directories where the programs and their
  29. documentation will be installed, or the optimization options, edit
  30. `Makefile' and change those values.  If you have an unusual system
  31. that needs special compilation options that `configure' doesn't know
  32. about, and you didn't pass them in the environment when running
  33. `configure', you should add them to `Makefile' now.  Alternately,
  34. teach `configure' how to figure out that it is being run on a system
  35. where they are needed, and mail the diffs to the address listed at the
  36. end of this file so we can include them in the next release.
  37.  
  38. If you are not running NIS or Hesiod, you might want to add the option
  39. -DCACHE_IDS to the Makefile DEFS; it could speed up the -nouser and
  40. -nogroup options to find.  See the comment in the Makefile for more
  41. information.
  42.  
  43. 3.  In the top-level directory, type `make'.  You don't need to
  44. otherwise touch the Makefiles in the subdirectories or use them
  45. directly.
  46.  
  47. 4.  If the programs compile successfully, type `make install' to
  48. install them and their documentation.
  49.  
  50. 5.  After you have installed the programs and documentation, you can
  51. remove the binaries from the source directories by typing `make
  52. clean'.  Type `make distclean' if you also want to remove the
  53. Makefiles that `configure' created, for instance if you are going to
  54. recompile the utilities next on another type of machine.
  55.  
  56.  
  57. Other things to note:
  58.  
  59. The locate utility is based on James Woods' public domain fast-find
  60. code, which is also distributed with the 4.3BSD find.  Because POSIX
  61. requires `find foo' to have the same effect as `find foo -print', the
  62. fast-find searching has been moved to a separate program, `locate';
  63. the same thing has been done in 4.3BSD-reno/4.4BSD.  If you use
  64. locate, you should run the included `updatedb' script from cron
  65. periodically (typically nightly).
  66.  
  67. Mail suggestions and bug reports for these programs to
  68. bug-gnu-utils@prep.ai.mit.edu.
  69.